home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / graphics / graphics3d / graphics3d.readme < prev    next >
Text File  |  1999-05-25  |  7KB  |  141 lines
  1. Short:      3D graphics shared library V15.10
  2. Uploader:   p.biancalani@mbox.match.it
  3. Author:     p.biancalani@mbox.match.it
  4. Type:       util/libs
  5. Version        15.10
  6.  
  7. --- English ----
  8. First sorry for my bad English but I don't know it very well.
  9. This is a simple but complete graphic 3D library that use for visualization
  10. only the system library .
  11. Main feature include :
  12.  
  13.    - Visualization of object in systems windows with single buffering.
  14.    - Support of polygons with one, two, tree and four vertex.
  15.    - Use of only fix point value than the math coprocessor is not
  16.      necessary, and is relatively fast on machines us A1200 base too.
  17.    - Implementation of visualization in Wire Frame ,Solid shading ,
  18.      Flat shading and now Goraud shading all simultaneous too and with light 
  19.      source freely placeable .
  20.    - Support of Z-Buffering.
  21.    - Support of Texture mapping with combination of other metod (except of
  22.      wireframe)and support of trasparent color.
  23.    - Add support of virtual color so the color of object is can be indipendent
  24.      from the number of color of the screen, see doc and example for more
  25.      informations.
  26.    - Direct loading of object with a custom format (is present an object converter
  27.      from .plg and .tddd object to this format)
  28.  
  29. New in this version:
  30. Any bugs fixed in clipping and rotate function and any minor change on tree 
  31. function, see history file.
  32.  
  33. Is tested on (for now): 
  34.    A4000/40 with S.O. 3.0
  35.  
  36. Sorry but I have suppressed the 68000 version for problem in linking.
  37. But if any necessed of this its will can be reintegrated. 
  38.  
  39. THIS LIBRARY IS A COPYRIGHT OF THE AUTHOR PATRIZIO BIANCALANI AND IS A 
  40. FREEWARE SOFTWARE THAN FREELY USABLE AND DISTRIBUITE BUT WITH ALL FILE OF 
  41. ORIGINAL ARCHIVE AND NOT FOR RESALE OR IT CAN'T BE SOLD, THAN I PROVIDE 
  42. ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
  43. IF YOU WANT MODIFY THE ORIGINAL SOURCES TELL ME THIS THAN ,IF IT IS OK, 
  44. I CAN UPDATE ALL ORIGINAL ARCHIVE.
  45. It is very pleasant if you send me an e-mail if you use it.
  46.  
  47. I have included an example write in E (and full commented) and all the source
  48. in C of this library .The executable is 3dlib and it must be in the same
  49. directory of #?.plg files.It can use more colours with the parameter "256" in the
  50. command string (for machine with almost AGA and S.O. 3.0).
  51.  
  52. The file graphics3d_020_CPU.library is the library for CPU from 68020 with new metod of rendering.
  53. The file graphics3d_020_BLT.library is the library for CPU from 68020 with old metod of rendering.
  54. You must rename the correct library to graphics3d.library before use it.
  55.  
  56. Thanks to:
  57.    Maciej R.Gorny for the original routin of engine 3D.
  58.    Alessandro Franchi for beta testing on A1200.
  59.    VolKer Barthelmann author of VBCC the C compiler used by me to write the
  60.    library.
  61.    Andreas Kleinert author of the optimal startupcode for write shared
  62.    library. 
  63.    Nautilus that have explain to me the algoritm to do goraud shading , z-buffer
  64.    and texture mapping.
  65.    The authors of Tornado3D for the suggetions to implemented the single
  66.    buffering in a window. 
  67.    All ones that have write an e-mail to me.
  68.  
  69. I'am Patrizio Biancalani from Prato (Italy) and the my E-Mail for
  70. suggestions and signaling is :p.biancalani@mbox.match.it
  71.  
  72. Support site :www.amigaworld.com/support/graphics3dlib/welcome.html
  73.  
  74. --- Italiano ---
  75.  
  76. Questa e' una semplice ma completa libreria grafica 3D che si appoggia
  77. interamente sulle librerie di sistema per la visualizzazione.
  78. Le caratteristiche principali sono:
  79.    
  80.    - Visualizzazione oggetti nelle finestre con single buffering.
  81.    - Supporto di poligoni a uno, due, tre e quattro vertici. 
  82.    - Usa valori solo in fix point quindi il coprocessore non serve
  83.      ed e' relativamente veloce anche su macchine come il A1200 base.
  84.    - Implementa la visualizzazione in Wire Frame ,Solid shading, 
  85.      Flat shading ed ora Goraud shading anche tutti contemporaneamente e con 
  86.      la fonte di luce posizionabile a piacere.
  87.    - Supporto dello Z-Buffering.
  88.    - Supporto del Texture mapping in combinazione con gli altri metodi (ad
  89.      eccezione del wireframe) e supporto del colore trasparente.
  90.    - Aggiunto il supporto dei colori virtuali cosi' che il colore degli oggetti
  91.      oggetti sia indipendente dal numero di colori dello schermo.
  92.      Per maggiori informazioni vedi l'esempio e la documentazione.
  93.    - Supporta il caricamento di oggetti in formato propietario.(E' presente un 
  94.      convertitore da oggetti .plg e .tddd verso tale formato).
  95.  
  96. Novita' in questa versione:
  97. Eliminati alcuni bug nelle funzioni di clipping e rotazione , effettuate anche
  98. alcune variazioni su tre funzioni , vedere l'history file.
  99.  
  100. E' stata testata su(per ora):
  101.    A4000/40 con S.O. 3.0
  102.  
  103. Spiacente ma il supporto del 68000 e' stato soppresso per problemi nel linkaggio.
  104. Ma se fosse necessario a qualcuno posso sempre cercare di reintegrarlo.
  105.  
  106. QUESTA LIBRERIA E' UN COPYRIGHT DELL'AUTORE PATRIZIO BIANCALANI ED E' UN
  107. FREEWARE SOFTWARE QUINDI LIBERAMENTE DISTRIBUIBILE MA CON TUTTI I FILE
  108. DELL'ARCHIVIO ORIGINALE E NON PER FINI DI LUCRO, IO NON FORNISCO 
  109. ASSOLUTAMENTE ALCUNA GARANZIA SU QUESTO SOFTWARE.
  110. SE VOLETE MODIFICARE I SORGENTI ORIGINALI COMUNICATEMELO, SE E' ACCETTABILE
  111. IO AGGIORNERO' L'ARCHIVIO ORIGINALE.
  112. E' molto gradita la ricezione di un e-mail in caso di uso della libreria. 
  113.  
  114. Ho incluso anche un esempio di uso scritto in E e i sorgenti in C della
  115. libreria.L'eseguibile si chiama 3dlib e deve essere nella stessa directory
  116. dei file #?.plg .Se si da il parametro "256" nella stringa di comando si potranno
  117. usare piu' colori (solo per macchine con almeno l'AGA e il S.O. 3.0). 
  118.  
  119. Il file graphics3d_020_CPU.library e' per le CPU dal 68020 con nuovo metodo di visualizzazione.
  120. Il file graphics3d_020_BLT.library e' per le CPU dal 68020 con vecchio metodo di visualizzazione.
  121. Occorre rinominare la corretta libreria in graphics3d.library prima di
  122. usarla.
  123.  
  124. Si ringrazia :
  125.    Maciej R.Gorny per le routin del motore 3D.
  126.    Alessandro Franchi per il parziale beta testing su A1200.
  127.    VolKer Barthelmann autore del compilatore C VBCC da me usato per
  128.    la stesura della libreria.
  129.    Andreas Kleinert autore dell'ottimo startupcode per le shared
  130.    library. 
  131.    Nautilus che mi ha spiegato l'algoritmo per il goraud shading , lo z-buffer
  132.    e il texture mapping.
  133.    Gli autori di Tornado3D per il suggerimento su come implementare 
  134.    il single buffering in una finestra.
  135.    Tutti quelli che mi hanno scritto.
  136.  
  137. Io sono Patrizio Biancalani residente a Prato Italy e il mio E-Mail per
  138. suggerimenti e segnalazioni e': p.biancalani@mbox.match.it
  139.  
  140. Sito di supporto :www.amigaworld.com/support/graphics3dlib/welcome.html
  141.